hal_crypt.h

Go to the documentation of this file.

#ifndef HAL_CRYPT_H
#define HAL_CRYPT_H
 
/* ******************** HAL terminal crypto functions API declaration ********************** */
/* ***************************************************************************************** */
 
/* set struct alignment */
#include <emv_platform_set_align.h>
 
/* ***************************************************************************************** */
/* ***************************************************************************************** */
 
/* ********************************* HAL Crypto marcos ************************************* */
/* ***************************************************************************************** */
#define KER_HASH_ALG_TC_HASH                        0   
#define KER_HASH_ALG_SHA1                               1   
#define KER_HASH_ALG_SHA256                         2   
#define KER_HASH_ALG_SHA512                         3   
#define KER_HASH_ALG_SHA3_256                       4   
#define KER_HASH_ALG_SHA3_512                       5   
#define KER_HASH_ALG_SM3                                6   
/* ***************************************************************************************** */
#define KER_CRYPT_ALG_DES                               0     
#define KER_CRYPT_ALG_AES                               10  
/* ***************************************************************************************** */
#define KER_CA_PK_SCHEME_NA                         0   
#define KER_CA_PK_SCHEME_RSA                        1   
#define KER_CA_PK_SCHEME_ECC                        2   
/* ***************************************************************************************** */
#define KER_REC_ALG_RSA_EMV                         1   
/* ***************************************************************************************** */
#define KER_HASH_SHA1_LEN                               20  
#define KER_HASH_SHA256_LEN                         32  
#define KER_HASH_SHA512_LEN                         64  
#define KER_HASH_SHA3_256_LEN                       32  
#define KER_HASH_SHA3_512_LEN                       64  
#define KER_HASH_SM3_LEN                                32  
/* ***************************************************************************************** */
#define KER_PK_MODULUS_LEN                          248 
#define KER_PK_EXP_LEN                                  3       
#define KER_PK_HASH_LEN                                 20  
#define KER_ECC_PK_P256_LEN                         32  
#define KER_ECC_PK_P521_LEN                         66  
/* ***************************************************************************************** */
#define KER_ECC_ASI_EC_SDSA_SHA256_P256             1       
#define KER_ECC_ASI_EC_SDSA_SHA512_P521             2       
#define KER_ECC_ASI_EC_SDSA_SHA3_256_P256           3       
#define KER_ECC_ASI_EC_SDSA_SHA3_512_P521           4       
#define KER_ECC_ASI_SM2_DSA_SM3_SM2_P256            5       
#define KER_ECC_ASI_ODE_DH_EtM_AES_P256             20  
#define KER_ECC_ASI_ODE_DH_EtM_AES_P521             21  
#define KER_ECC_ASI_ODE_DH_EtM_SM4_SM2_P256     22  
/* ******************************** hal_crypt_get_hash_len ********************************* */
extern KER_INT16U hal_crypt_get_hash_len(KER_CTX_PARAM KER_BYTE btAlg);
 
/* ******************************** hal_crypt_calc_hash ************************************ */
extern KER_BOOL hal_crypt_calc_hash(KER_CTX_PARAM KER_BYTE btAlg, KER_VOID* pExtra, const KER_BYTE* pbtDataBuffer, KER_INT16U usDataBufferLen, KER_BYTE* pbtHash, KER_INT16U* pusHashLen, KER_INT16U usHashSize);
 
/* ****************************** hal_crypt_calc_hash_init ********************************* */
extern KER_BOOL hal_crypt_calc_hash_init(KER_CTX_PARAM KER_BYTE btAlg, KER_VOID* pExtra, KER_VOID** ppHashHandle);
 
/* ***************************** hal_crypt_calc_hash_update ******************************** */
extern KER_BOOL hal_crypt_calc_hash_update(KER_CTX_PARAM KER_VOID* pHashHandle, KER_BYTE btAlg, const KER_BYTE* pbtDataBuffer, KER_INT16U usDataBufferLen);
 
/* **************************** hal_crypt_calc_hash_complete ******************************* */
extern KER_BOOL hal_crypt_calc_hash_complete(KER_CTX_PARAM KER_VOID* pHashHandle, KER_BYTE btAlg, KER_BYTE* pbtHash, KER_INT16U* pusHashLen, KER_INT16U usHashSize);
 
/* **************************** hal_crypt_unpredict_num_calc ******************************* */
extern KER_BOOL hal_crypt_unpredict_num_calc(KER_CTX_PARAM KER_INT16U usUnpredNumLen, KER_BYTE* pbtUnpredNum);
 
/* *************************** hal_crypt_unpredict_num_set_ac ****************************** */
extern KER_BOOL hal_crypt_unpredict_num_set_ac(KER_CTX_PARAM const KER_BYTE* pbtAc, KER_INT16U usAcLen);
 
/* ********************************** hal_crypt_encrypt ************************************ */
extern KER_BOOL hal_crypt_encrypt(KER_CTX_PARAM KER_BYTE btAlg, const KER_BYTE* pbtKey, KER_INT16U usKeyLen, const KER_BYTE* pbtIV, KER_INT16U usIVLen, const KER_BYTE* pbtData, KER_INT16U usDataLen, KER_BYTE* pbtResult, KER_INT16U* pusResultLen, KER_INT16U usMaxLen);
 
/* ********************************** hal_crypt_decrypt ************************************ */
extern KER_BOOL hal_crypt_decrypt(KER_CTX_PARAM KER_BYTE btAlg, const KER_BYTE* pbtKey, KER_INT16U usKeyLen, const KER_BYTE* pbtIV, KER_INT16U usIVLen, const KER_BYTE* pbtEncryptedData, KER_INT16U usEncryptedDataLen, KER_BYTE* pbtResult, KER_INT16U* pusResultLen, KER_INT16U usMaxLen);
 
typedef struct tag_HAL_CRYPT_PK
{
    KER_INT16U  usSize;                     
    KER_BYTE btVer;                             
    KER_BYTE btScheme;                      
    union
    {
        struct
        {
            KER_BYTE btSignAlg;             
            KER_BYTE btHashAlg;             
            KER_BYTE ar_btModulus[KER_PK_MODULUS_LEN];  
            KER_INT16U usModulusLen;    
            KER_BYTE ar_btExp[KER_PK_EXP_LEN];                  
            KER_INT16U usExpLen;            
            KER_BYTE ar_btHash[KER_PK_HASH_LEN];                
            KER_INT16U usHashLen;           
        }RSA;                                               
        struct
        {
            KER_BYTE btASI;                     
            KER_BYTE ar_btPK[KER_ECC_PK_P521_LEN];          
            KER_INT16U usPKLen;             
        }ECC;                                               
    }Scheme;                                            
}HAL_CRYPT_PK;
 
/* ********************************* hal_crypt_get_ca_pk *********************************** */
extern KER_BOOL hal_crypt_get_ca_pk(KER_CTX_PARAM KER_BYTE btKernelID, const KER_BYTE* pbtRID, KER_BYTE btRIDLen, KER_BYTE btKeyIndex, HAL_CRYPT_PK* pCA_PK);
 
/* ******************************* hal_crypt_msg_recovery ********************************** */
extern KER_BOOL hal_crypt_msg_recovery(KER_CTX_PARAM const KER_BYTE* pbtPK, KER_INT16U usPKLen, const KER_BYTE* pbtExp, KER_INT16U usExpLen, KER_BYTE btAlg,
                                                                                const KER_BYTE* pbtMsg, KER_INT16U usMsgLen, KER_BYTE* pbtResult, KER_INT16U* pusResultLen, KER_INT16U usMaxLen);
 
 
typedef struct tag_HAL_CRYPT_CERT_INFO
{
    KER_INT16U  usSize;                             
    KER_BYTE btVer;                                     
    const KER_BYTE* pbtCertSerial;      
    KER_INT16U usCertSerialLen;             
}HAL_CRYPT_CERT_INFO;
 
/* *************************** hal_crypt_check_cert_revocation ***************************** */
extern KER_BOOL hal_crypt_check_cert_revocation(KER_CTX_PARAM KER_BYTE btKernelID, const KER_BYTE* pbtRID, KER_BYTE btRIDLen, KER_BYTE btKeyIndex, const HAL_CRYPT_CERT_INFO* pCert);
 
/* ************************* hal_crypt_check_ecc_cert_revocation *************************** */
extern KER_BOOL hal_crypt_check_ecc_cert_revocation(KER_CTX_PARAM KER_BYTE btKernelID, const KER_BYTE* pbtRID, KER_BYTE btRIDLen, KER_BYTE btKeyIndex, const HAL_CRYPT_CERT_INFO* pCert);
 
/* ******************************** hal_ecc_get_sign_len *********************************** */
extern KER_INT16U hal_ecc_get_sign_len(KER_CTX_PARAM KER_BYTE btASI);
 
/* ********************************** hal_ecc_get_pk_len *********************************** */
extern KER_INT16U hal_ecc_get_pk_len(KER_CTX_PARAM KER_BYTE btASI);
 
/* ******************************* hal_ecc_msg_sign_check ********************************** */
extern KER_BOOL hal_ecc_msg_sign_check(KER_CTX_PARAM KER_BYTE btASI, const KER_BYTE* pbtPK, KER_INT16U usPKLen, const KER_BYTE* pbtMsg, KER_INT16U usMsgLen, const KER_BYTE* pbtSignature, KER_INT16U usSignatureLen);
 
/* ********************************** hal_ecc_pk_check ************************************* */
extern KER_BOOL hal_ecc_pk_check(KER_CTX_PARAM KER_BYTE btASI, const KER_BYTE* pbtPK, KER_INT16U usPKLen);
 
/* ***************************** hal_ecc_msg_sign_check_init ******************************* */
extern KER_BOOL hal_ecc_msg_sign_check_init(KER_CTX_PARAM KER_BYTE btASI, const KER_BYTE* pbtPK, KER_INT16U usPKLen, const KER_BYTE* pbtSignature, KER_INT16U usSignatureLen, KER_VOID** ppCheckHandle);
 
/* **************************** hal_ecc_msg_sign_check_update ****************************** */
extern KER_BOOL hal_ecc_msg_sign_check_update(KER_CTX_PARAM KER_VOID* pCheckHandle, const KER_BYTE* pbtMsg, KER_INT16U usMsgLen);
 
/* ***************************** hal_ecc_msg_sign_check_complete ******************************* */
extern KER_BOOL hal_ecc_msg_sign_check_complete(KER_CTX_PARAM KER_VOID* pCheckHandle, KER_BYTE btASI, const KER_BYTE* pbtPK, KER_INT16U usPKLen, const KER_BYTE* pbtSignature, KER_INT16U usSignatureLen);
 
/* restore struct alignment */
#include <emv_platform_restore_align.h>
 
#endif /* HAL_CRYPT_H */